home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / colorit2.zip / COLORIT.DOC next >
Text File  |  1988-07-16  |  5KB  |  97 lines

  1.  
  2. -------------------------------------------------------------------------------
  3.  
  4.  
  5.                   COLORIT.EXE
  6.  
  7.                   VERSION 2.0
  8.  
  9.                    07/16/88
  10.  
  11.                  Written by Bill Dimes
  12.  
  13.  
  14. -------------------------------------------------------------------------------
  15.  
  16.  
  17. COLORIT is a file colorizer utility.  It will accept any pure text file created
  18. by word processors or text editors and create a colorized version of that file
  19. written to your parameters.  It is useful in creating bulletins and screens for
  20. BBS systems as well as text screens for menus used for DOS or any other purpose
  21. where you may need an ANSI color screen.  With COLORIT, you can throw a quick
  22. text file together with an editor, then run it through and colorize it, put a
  23. border around it, even center all the lines, automatically!  You will get both
  24. a colorized version and a monochrome version will all the borders and
  25. centering!
  26.  
  27.  
  28. COLORIT is PUBLIC DOMAIN SOFTWARE.  You may copy and distribute it as you wish.
  29. All I ask is that you do NOT alter the file in any way and you distribute this
  30. documentation file along with COLORIT.EXE.  Use COLORIT at YOUR OWN RISK!  I
  31. take no responsibility for anything that may happen during it's use.
  32.  
  33.  
  34. COLORIT is written in C.  It is fast and small. It's also very easy to operate,
  35. but I'll run down all the details here.  Remember, you must have a TRUE TEXT
  36. FILE, with lines ending with a CR LF combination.  This is pretty much standard
  37. with most word processors and all text editors.  The file you are colorizing
  38. should not contain ansi codes already and no line may be longer than 80
  39. characters.  COLORIT will handle leading spaces and the tab character.
  40.  
  41. To operate COLORIT, simply type COLORIT at the dos command prompt.  The
  42. screen will clear and display a heading containing your color choices.  If you
  43. see a bunch of numbers and symbols instead of colors, you do not have ANSI.SYS
  44. loaded.  COLORIT requires ANSI.SYS to operate.  To load ANSI.SYS, simply
  45. place the line DEVICE=ANSI.SYS in your CONFIG.SYS file and place ANSI.SYS in
  46. your root dir and reboot your machine.  Most of you already know this, so I
  47. will go on.
  48.  
  49. The first prompt is for the input file name.  You may enter your text filename
  50. here, or a drive:path\filename for the input file. e.g. BLT1 or c:\pcb\gen\blt1
  51.  
  52. Next is the output file name.  You will enter the filename you want the output
  53. of the colorized file to go to.  You may also enter a drive:path\filename here.
  54. e.g.  BLT1G  or c:\pcb\gen\blt1g
  55.  
  56. Next is the output file name for the MONOCHROME version of the file. You may
  57. enter the same types of things as the other two file names.  This file will
  58. contain no color codes, but will have all the frames and centering and will
  59. look identical to the color version except in mono.
  60.  
  61. Next you will be asked for the Main text Foreground and Background Colors.
  62. Pick them from the chart at the top of the screen.  You will notice that the
  63. foreground colors may be any of the 16 colors, but the background may only be
  64. picked from the first 8.
  65.  
  66. The next prompt asks you if you want the screen to be cleared at the beginning
  67. of the file.  Simply type Y or N here.
  68.  
  69. Next you will be asked if you want to AUTO-CENTER each line.  What this does is
  70. first to clear out any leading spaces or tabs on each line, then center the
  71. remaining text.  With this option, you can use a text editor to throw a quick
  72. text file together, then run it through COLORIT and center it all up and color
  73. it!
  74.  
  75. Next you will be asked for a Foreground and Background color to set on exit.
  76. What this does is when the file is finished displaying, this will be the last
  77. color set, so the following dos prompts of board displays will be in the color
  78. you pick here.
  79.  
  80. Now you will be asked what type of border you want.  You can have a single line
  81. double line or no border at all.  If you use a border, you lines will be
  82. truncated to 77 characters to leave room for the border characters.  With no
  83. border, you can use up to 79 characters.
  84.  
  85. If you have chosen to use a border you will now be asked for the border
  86. foreground and background colors.
  87.  
  88. As the file is colorized, you will see the output on the screen.
  89.  
  90. I hope you enjoy this utility.  I can see where it can be put to good use on
  91. many systems to painlessly color those long bulletins and other text files.
  92. Call my BBS for information on doors I have written and other files.
  93.  
  94.                   Bill Dimes
  95.             The Billboard Door Support BBS
  96.           (714) 943-4301       300/1200/2400/9600 HST
  97.